Motion.UpdateCommand method

Updates the motion parameters of a command.

Namespace: IntervalZero.KINGSTAR.OpcUa.Api

Assembly: IntervalZero.KINGSTAR.OpcUa.Api (in IntervalZero.KINGSTAR.OpcUa.Client.dll) Version: 4.4.0.0

Syntax

C#VB

public KsCommandStatus UpdateCommand(
       double Position,
       double Velocity,
       double EndVelocity,
       double Acceleration,
       double Deceleration,
       double Jerk,
       KsCommandStatus Status
)

Public Function UpdateCommand(
       Position As Double,
       Velocity As Double,
       EndVelocity As Double,
       Acceleration As Double,
       Deceleration As Double,
       Jerk As Double,
       Status As KsCommandStatus
) As KsCommandStatus

Parameters

Position

Type: double

The commanded position for the motion. [unit] (negative or positive)

Velocity

Type: double

A value of the maximum velocity. [unit/second]

EndVelocity

Type: double

A value of the end velocity. Signed value. [unit/second]

Acceleration

Type: double

A value of the acceleration. Always positive. The unit is determined by McProfileType. (increasing power of the motor) [unit/second²] or [second]

Deceleration

Type: double

A value of the deceleration. Always positive. The unit is determined by McProfileType. (decreasing power of the motor) [unit/second²] or [second]

Jerk

Type: double

A value of the jerk. Always positive. The unit is determined by McProfileType. [unit/second³] or [second]

Status

Type: KsCommandStatus

A KsCommandStatus class returns from a motion command.

Return value

Type: KsCommandStatus

Returns the KsCommandStatus class.

Remarks

When modulo axis is enabled, the modulo value will be applied to the target position of MoveAxisAbsolute and MoveAxisContinuousAbsolute. After the target position is updated, MoveAxisAbsolute and MoveAxisContinuousAbsolute will recalculate the distance based on the configured Direction.
The following table shows the functions and their parameters that can be used with UpdateCommand.

Methods	Parameters
Motion.HaltAxis	Deceleration, Jerk
Motion.InchAxis	Distance, Velocity, EndVelocity, Acceleration, Deceleration, Jerk
Motion.JogAxis	Velocity, EndVelocity, Acceleration, Deceleration, Jerk
Motion.MoveAxisAbsolute	Position, Velocity, Acceleration, Deceleration, Jerk
Motion.MoveAxisAdditive	Distance, Velocity, Acceleration, Deceleration, Jerk
Motion.MoveAxisContinuousAbsolute	Position, Velocity, EndVelocity, Acceleration, Deceleration, Jerk
Motion.MoveAxisContinuousRelative	Distance, Velocity, EndVelocity, Acceleration, Deceleration, Jerk
Motion.MoveAxisRelative	Distance, Velocity, Acceleration, Deceleration, Jerk
Motion.MoveAxisVelocity	Velocity, EndVelocity, Acceleration, Deceleration, Jerk
Motion.SetAxisGear	Acceleration, Deceleration, Jerk
Motion.StopAxis	Deceleration, Jerk
Motion.HaltGroup*	Deceleration, Jerk
Motion.InchGroup*	Acceleration, Deceleration, Jerk
Motion.JogGroup*	Acceleration, Deceleration, Jerk
Motion.MoveLinearAbsolute*	Velocity, Acceleration, Deceleration, Jerk
Motion.MoveLinearRelative*	Velocity, Acceleration, Deceleration, Jerk
Motion.MoveLinearAdditive*	Velocity, Acceleration, Deceleration, Jerk
Motion.MoveCircularAbsolute*	Velocity, Acceleration, Deceleration, Jerk
Motion.MoveCircularRelative*	Velocity, Acceleration, Deceleration, Jerk
Motion.MoveCircularAdditive*	Velocity, Acceleration, Deceleration, Jerk
Motion.MoveHelicalAbsolute*	Velocity, Acceleration, Deceleration, Jerk
Motion.MoveHelicalRelative*	Velocity, Acceleration, Deceleration, Jerk
Motion.MoveHelicalAdditive*	Velocity, Acceleration, Deceleration, Jerk
Motion.StopGroup*	Deceleration, Jerk

* Starting from KINGSTAR 4.5, UpdateCommand supports group motion APIs and their parameters listed on the table.

Examples

N/A